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Environment Variable APIs 


Environment variables are character strings of the form "name=value". There are two types of 
environment variables: 


e Job-level environment variables. The job-level environment variables are stored in an environment 
space outside of the program associated with the job. They can be manipulated by using the 
getenv(), putenv(), Qp0zDItEnv(), Qp0zGetEnv(), Qp0zInitEnv(), and Qp0zPutEnv() APIs, as 
well as the CL commands ADDENVVAR, CHGENVVAR, RMVENVVAR, and WRKENVVAR. 
These variables exist for the duration of the job or until they are deleted. There is a limit of 4095 
job-level environment variables. 


e System-level environment variables. The system-level environment variables are stored in a global 
environment space that is persistent across IPLs and is not associated to a particular job. They can 
be manipulated by using the Qp0zDItSysEnv(Q), Qp0zGetAllSysEnv(), Qp0zGetSysEnv(), and 
Qp0zPutSysEnv() APIs, as well as the CL commands ADDENVVAR, CHGENVVAR, 
RMVENVVAR, and WRKENVVAR. These variables exist until they are deleted. There is a limit 
of 4095 system-level environment variables. 


When a job calls one of the job-level environment variable APIs or CL commands for the first time, it 
inherits the system-level environment variables onto its job-level environment space. Any changes to 
job-level and system-level environment variables are then independent of one another. 


The temporary space where the job-level environment variables are stored allows read and write access. 
Therefore, it is possible for the space to be corrupted. This could occur if a programmer accesses the space 
directly using the environ array rather than using the environment variable APIs. If the space is corrupted, 
subsequent calls using the APIs will have unpredictable results. 


The environment variable APIs are: 


e@ getenv() (Get value of environment variable) searches the job-level environment list for a string of 
the form name=value, where name is the environment variable and value is the value of the 
variable. 

@ putenv( (Change or add environment variable) sets the value of a job-level environment variable 
by changing an existing variable or creating a new one. 

e Qp0zDItEnv( (Delete an environment variable) deletes a single job-level environment variable or 
deletes all environment variables from the current job. 

e Qp0zDitSysEnvQ (Delete a system-level environment variable) deletes a single system-level 
environment variable or deletes all system-level environment variables. 

e@ Op0zGetAllSysEnvQ (Get all system-level environment variables) fills in the list_buf with a list of 
all the system-level environment variables. 

e@ Qp0zGetEnv() (Get value of environment variable (extended)) is an OS/400 extension to the 
standard getenv() function. 


@ Qp0zGetSysEnv() (Get value of system-level environment variable) gets the value of a 


system-level environment variable name by searching the system-level environment variable list 
for a string of the form name=value. 


e QpO0zInitEnv() (Initialize environment for variables) sets the external variable environ to a pointer 
to the current environment list. 


e@ Qp0zPutEnv() (Change or add environment variable (extended)) is an OS/400 extension to the 
standard putenv() function. 


e@ Qp0zPutSysEnv() (Change or add a system-level environment variable) sets the value of a 


system-level environment variable by altering an existing variable or creating a new variable. 


Note: These functions use header (include) files from the library QS YSINC, which is optionally installable. 
Make sure QSYSINC is installed on your system before using any of the functions. See Header Files for 


UNIX-Type Functions for the file and member name of each header file. 
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getenv()--Get Value of Environment Variable 


Syntax 


#include <stdlib.h> 


char *getenv(const char *name); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Yes. See Usage Notes for more information. 


The getenv() function searches the job-level environment list for a string of the form name=value, where name is the environment 
variable and value is the value of the variable. 


The name parameter does not include the equal (=) symbol or the value of the environment variable name=value pair. 


Parameters 


name 


(Input) The name of an environment variable. 


Return Value 


value getenv() successfully found the environment string. The value returned is a pointer to the string 
containing the value for the specified name in the current environment. 


NULL getenv() could not find the environment string. The errno variable is set to indicate the error. 


Error Conditions 
If getenv() is not successful, errno indicates one of the following errors. 
[EDAMAGE] A damaged object was encountered. 


A referenced object is damaged. The object cannot be used. 
[[EFAULT]] The address used for an argument is not correct. 


In attempting to use an argument in a call, the system detected an address that 
is not valid. 


While attempting to access a parameter passed to this function, the system 
detected an address that is not valid. 


[ENOENT] No such path or directory. 
The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


No entry found for name specified. 
[EUNKNOWN] Unknown system state. 


The operation failed because of an unknown system state. See any messages in 
the job log and correct any errors that are indicated, then retry the operation. 


Usage Notes 


1. Although getenv() is threadsafe, if a thread calls an environment variable function while another thread is accessing an 
environment variable from the environ array the thread may see undefined results. The environ array can be accessed directly or 
by using a pointer returned from the getenv() or Qp0zGetEnv() functions. The environment contents are only protected during 
calls to the environment variable functions. 


2. All environment variables are stored with an associated CCSID (coded character set identifier). Unless a different CCSID is 
specified, such as by using Qp0zPutEnv(), the default CCSID for the job is used as the CCSID associated with each 
environment variable string. 


3. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer value associated with each 
environment variable. 


Related Information 


@ putenv()--Change or Add Environment Variable 


e Qp0zDIitEnv()--Delete an Environment Variable 


e Qp0zDitSysEnv()--Delete a System-Level Environment Variable 
e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


@ Qp0zGetSysEnvQ--Get Value of System-Level Environment Variable 


e Qp0zInitEnv()--Initialize Environment for Variables 


e@ Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


e Qp0zPutSysEnv()--Change or Add a System-Level Environment 


Example 


See the example of using getenv() in putenv()--Change or Add Environment Variable. 


For other examples, see the following: 


e Using Environment Variables 


e Using the Spawn Process and Wait for Child Process APIs 


e Using the Spawn Process (using NLS-enabled path name) 


API Introduced: V3R6 
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putenv()--Change or Add Environment Variable 


Syntax 


#include <stdlib.h> 


int putenv(const char *string);; 


Threadsafe: Yes. See Usage Notes for more information. 


The putenv() function sets the value of a job-level environment variable by changing an existing variable 
or creating a new one. The string parameter points to a string of the form name=value, where name is the 
environment variable and value is the new value for it. 


The name cannot contain a blank. For example, 


PATH NAME=/my_lib/joe_user 
is not valid because of the blank between PATH and NAME. The name can contain an equal (=) symbol, 


but the system interprets all characters following the first equal symbol as being the value of the 
environment variable. For example, 


PATH=NAME=/my_lib/joe_user 


will result in a value of 'NAME=/my_lib/joe_user' for the variable PATH. 


Parameters 


string 


(Input) A pointer to the name=value string. 


Return Value 


0 
putenv() was successful. 
-1 


putenv() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If putenv() is not successful, errno indicates one of the following errors. 
[EDAMAGE] 


A damaged object was encountered. 


A referenced object is damaged. The object cannot be used. 
[EFAULT] 


The address used for an argument is not correct. 

In attempting to use an argument in a call, the system detected an address that is not valid. 

While attempting to access a parameter passed to this function, the system detected an address that 
is not valid. 


[EINVAL] 


An invalid parameter was found. 
A parameter passed to this function is not valid. 


For example, the string may not be in the correct format. 
[ENOMEM] 


Storage allocation request failed. 
A function needed to allocate storage, but no storage is available. 


There is not enough memory to perform the requested function. (There is a limit of 4095 
environment variables per job.) 


[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and 
correct any errors that are indicated, then retry the operation. 


Usage Notes 


1. Although putenv() is threadsafe, if a thread calls an environment variable function while another 
thread is accessing an environment variable from the environ array the thread may see undefined 
results. The environ array can be accessed directly or by using a pointer returned from the getenv() 
or Qp0zGetEnv() functions. The environment contents are only protected during calls to the 
environment variable functions. 


2. All environment variables are stored with an associated CCSID (coded character set identifier). 
Because putenv() does not specify a CCSID, the default CCSID for the job is used as the CCSID 
associated with strings that are stored using putenv(). 


3. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer 
value associated with each environment variable. 


Related Information 


e getenv()--Get Value of Environment Variable 
Qp0zDItEnv()--Delete an Environment Variable 


Qp0zDitSysEnv()--Delete a System-Level Environment Variable 
e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 
Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


e Qp0zGetSysEnv()--Get Value of System-Level Environment Variable 


e Qp0zInitEnv(--Initialize Environment for Variables 
Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


Qp0zPutS ysEnv()--Change or Add a System-Level Environment 


Example 
The following example uses putenv() and getenv(). 


#include <stdio.h> 
#include <errno.h> 
#include <stdlib.h> 


int main(int argc, char **argv) 


{ 


char *varl = "PATH=/:/home/userid"; 
char *namel = "PATH"; 

char *vall = NULL; 

int rc; 

re putenv(varl); 

if (re < 0) { 


( 
printf("Error inserting <%s> in environ, errno = %d\n", 
varl, errno); 
return 1; 


} 


printf("<%$s> inserted in environ\n", varl); 


vall = getenv(namel); 
if (vall == NULL) { 
printf("Error retrieving <%s> from environ, errno = %d\n", 


namel, errno); 
return 1; 


} 


printf("<%$s> retrieved from environ, value is <%s>\n", 
namel, vall); 
return 0; 


} 


Output: 


<PATH=/:/home/userid> inserted in environ 
<PATH> retrieved from environ, value is </:/home/userid> 


For other examples, see the following: 


e Using Environment Variables. 


e Using the Spawn Process and Wait for Child Process APIs. 


e Using the Spawn Process (using NLS-enabled path name) 
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Qp0zDItEnv()--Delete an Environment Variable 


Syntax 


#include <qp0z1170.h> 


int QpOzDltEnv(const char *name) ; 


Threadsafe: Yes. See Usage Notes for more information. 


The Qp0zDItEnv() function deletes a single job-level environment variable or deletes all environment variables from the current job. If 
the name parameter is NULL, all environment variables in the job are deleted. 


The name parameter does not include the equal (=) symbol or the value of the environment variable name=value pair. 


Parameters 


name 
(Input) A pointer to the name part of the environment variable name=value string. 


Authorities 


None. 


Return Value 


Qp0zDItEnv() was successful. 


Qp0zDItEnv() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If Qp0zDItEnv() is not successful, errno indicates one of the following errors. 
[ENOENT] 
No such path or directory. 


The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


The parameter name is not NULL and does not point to an environment variable name that currently exists in the environment 
list. 


Usage Notes 


1. Although Qp0zDItEnv() is threadsafe, if a thread calls an environment variable function while another thread is accessing an 
environment variable from the environ array the thread may see undefined results. The environ array can be accessed directly or 
by using a pointer returned from the getenv() or Qp0zGetEnv() functions. The environment contents are only protected during 
calls to the environment variable functions. 


Related Information 


e getenv()--Get Value of Environment Variable 


@ putenv()--Change or Add Environment Variable 


@ Qp0zDitSysEnv()--Delete a System-Level Environment Variable 
@ Qp0zGetAllSysEnv()--Get All System-Level Environment Variables 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


e@ Qp0zGetS ysEnv()--Get Value of System-Level Environment Variable 


e@ Qp0zInitEnv()--Initialize Environment for Variables 


e@ Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


@ Qp0zPutSysEnv()--Change or Add a System-Level Environment 


Example 


The following example uses Qp0zDItEnv(), putenv() and the environ array. 


#include <stdio.h> 
#include <errno.h> 
#include <qp0z1170.h> 
#include <stdlib.h> 


extern char **environ; 


#define ASSERT(x, y) 
{ 1£ (!(x)) { 
printf ("Assertion Failed: " #x 
", Description: " y 
", errno=%d", errno); 
exit (EXIT_FAILURE) ; 
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} 
} 


int main(int argc, char **argv) 
{ 
int rc=0; 
int e=0; 
printf ("Enter Testcase - %s\n", argv[0]); 


re = putenv ("PATH=/usr/bin:/home/me: SLIBL%") ; 


ASSERT ((rce == 0), "putenv(PATH)"); 
re = putenv ("TEST0=42") ; 
ASSERT ((rce == 0), “"putenv(TESTO)"); 
re = putenv ("TEST1=42") ; 
ASSERT ((re == 0), “putenv(TEST1)"); 
printf ("Before delete, these environment variables are set: 
while (environ[e] != NULL) { 
printf("  %&s\n", environ[e]); 
++e; 


} 


printf ("Delete the environment variables\n"); 
re = Qp0zD1itEnv ("TESTO"); 

ASSERT ((rc==0), "Qp0zD1tEnv(TESTO)"); 

re = Qp0zD1tEnv("TEST1"); 

ASSERT ((rc==0), "“QpOzD1tEnv(TEST1)"); 


printf ("After delete, these environment variables are set: 


e=0; 
while (environ[e] != NULL) { 


\n"); 


\n"); 


printf("  %s\n", environ[e]); 
++e; 
} 
printf ("Main completed\n") ; 
return 0; 


Output: 


Enter Testcase -— QPOWTEST/TPZDLTEO 

Before delete, these environment variables are set: 
PATH=/usr/bin: /home/me: SLIBL% 
TESTO=42 
TEST1=42 

Delete the environment variables 

After delete, these environment variables are set: 
PATH=/usr/bin: /home/me: SLIBL% 

Main completed 
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Qp0zDItSysEnv()--Delete a System-Level Environment 
Variable 


Syntax 


#include <qp0z1170.h> 


int Qp0OzD1ltSysEnv(const char *name, void *reserved); 
Threadsafe: Yes 


The Qp0zDitSysEnv() function deletes a single system-level environment variable or deletes all system-level environment variables. If 
the name parameter is NULL, all system-level environment variables are deleted. 


The name parameter does not include the equal (=) symbol or the value part of the environment variable name=value pair. 


Parameters 


name 
(Input) The name of the environment variable to delete. 
reserved 


(Input) Reserved for future use. Currently, the only value allowed is NULL. 


Authorities 


*JOBCTL special authority is required to delete a system-level environment variable. 


Return Value 


Qp0zDItSysEnv() was successful. 
errval 


Qp0zDItSysEnv() was not successful. errval is set to indicate the error. 


Error Conditions 


If Qp0zDItSysEnv() is not successful, errval indicates one of the following errors. 
[EFAULT] 


The address used for an argument is not correct. 
In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that is not valid. 
[EINVAL] 


An invalid parameter was found. 
A parameter passed to this function is not valid. 


The value for the reserved parameter was not NULL. 
[ENOENT] 
No such path or directory. 


The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


The parameter name is not NULL and does not point to an environment variable name that currently exists in the environment 
list. 


[EPERM] 


Operation not permitted. 
You must have appropriate privileges or be the owner of the object or other resource to do the requested operation. 


You must have *JOBCTL special authority to delete a system-level environment variable. 
[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


e@ putenv()--Change or Add Environment Variable 


e Qp0zDItEnv()--Delete an Environment Variable 

e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 

@ Qp0zGetSysEnv()--Get Value of System-Level Environment Variable 


e Qp0zInitEnv()--Initialize Environment for Variables 


e Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


e Qp0zPutSysEnv()--Change or Add a System-Level Environment 


Example 


See the example of using Qp0zDItSysEnv() in Qp0zPutSysEnv()--Change or Add a System-Level Environment. 
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Qp0zGetAllSysEnv()--Get All System-Level Environment 
Variables 


Syntax 


#include <qp0z1170.h> 
int Qp0OzGetAllSysEnv(char *list_buf, int *list_buf_size, 


int *ccsid_buf, int *ccsid_buf_size, 
void *reserved) ; 


Threadsafe: Yes 


The Qp0zGetAllSysEnv() function fills in the list_buf with a list of all the system-level environment variables. The list consists of 
multiple null-terminated name=value strings followed by an ending null-terminator. The coded character set identifier (CCSID) 
associated with each name=value string is returned in the ccsid_buf buffer. 


Authorities 


None 


Parameters 


list_buf 
(Input/Output) The address of the buffer to receive the null-terminated name=va_lue list. 
list_buf_size 


(Input/Output) A pointer to an integer that contains the information about the size (in bytes) of the list_buf buffer. Before 
calling Qp0zGetAllSysEnv(), this parameter should be set to the size of list_buf. If the size of this parameter is large enough to 
receive the list, then this field will be set to the exact size of the list upon returning from Qp0zGetAllSysEnv(). If the size of 
this parameter is not large enough to receive the list, then this field will contain the exact size required and ENOSPC will be the 
return value. In this case, the list_buf is not modified. 


ccsid_buf 


(Input/Output) The address of the buffer to receive the CCSIDs of the environment variables. The order of the CCSIDs returned 
corresponds to the order of the variables returned in the list_buf 


ccsid_buf_size 


(Input/Output) A pointer to an integer that contains the information about the size (in bytes) of the ccsid_buf buffer. Before 
calling Qp0zGetAllSysEnv(), this should be set to the size of ccsid_buf. If this size is enough to receive the CCSID list, then 
this field will contain the exact size of the CCSIDs received upon returning from Qp0zGetAlISysEnv(). If this size is not 
enough to receive the CCSID list, then this field will contain the exact size required and ENOSPC will be the return value. In 
this case, the ccsid_buf is not modified. 


reserved 


(Input) Reserved for future use. Currently, the only allowed value is NULL. 


Return Value 


0 
Qp0zGetAllSysEnv() was successful. The 1ist_buf contains the null-terminated system-level environment variable strings, 
and the ccsid_buf contains the CCSID of each variable in the same order. The list_buf_size contains the exact size of the 
environment variable list, and the ccsid_buf_size contains the exact size of the CCSID list. 

errval 


Qp0zGetAllSysEnv() was not succesful. errval indicates the error. 


Error Conditions 


If Qp0zGetAllSysEnv() is not successful, errval indicates one of the following errors. 
[EFAULT] 


The address used for an argument is not correct. 
In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that is not valid. 
[EINVAL] 


An invalid parameter was found. 
A parameter passed to this function is not valid. 


The value for the reserved parameter was not NULL. 
[ENOENT] 
No such path or directory. 


The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


There were no system-level environment variables. 
[ENOSPC] 


No space available. 


The requested operations required additional space on the device and there is no space left. This could also be caused by 
exceeding the user profile storage limit when creating or transferring ownership of an object. 


Insufficient space remains to hold the intended file, directory, or link. 


The size of the buffers to receive the list and the CCSIDs was not enough. The /ist_buf_size and ccsid_buf_size parameters 
indicate the exact size needed for the list_buf ccsid_buf respectively. 


[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Usage Notes 


1. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer value associated with each 
environment variable. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


@ putenv()--Change or Add Environment Variable 


e Qp0zDItEnv()--Delete an Environment Variable 


e Qp0zDitSysEnv(Q--Delete a System-Level Environment Variable 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


e Qp0zGetSysEnv()--Get Value of System-Level Environment Variable 
e Qp0zInitEnv(--Initialize Environment for Variables 


e@ Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


e Qp0zPutSysEnv()--Change or Add a System-Level Environment 


Example 


1. See the example in Qp0zPutSysEnv()--Change or Add a System-Level Environment. 


2. See the two-part example in Appendix A for saving and restoring system-level environment variables. 
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Qp0zGetEnv()--Get Value of Environment Variable 
(Extended) 


Syntax 


#include <qp0z1170.h> 


char *QpO0zGetEnv(const char *name, int *ccsid); 


Threadsafe: Yes. See Usage Notes for more information. 


The Qp0zGetEnv() function is an OS/400 extension to the standard getenv() function. Qp0zGetEnv() searches the job-level 
environment list for a string of the form name=value. The value and the CCSID (coded character set identifier) associated with the 
environment variable name are returned. 


Parameters 


name 
(Input) The name of an environment variable. 

ccsid 
(Output) The CCSID for the named environment variable. 


Return Value 


value 


Qp0zGetEnv() successfully found the environment string. The value returned is a pointer to the string containing the value for 
the specified name in the current environment. 


NULL 


Qp0zGetEnv( could not find the environment string. The errno variable is set to indicate the error. 


Error Conditions 


If Qp0zGetEnv() is not successful, errno indicates one of the following errors. 
[EDAMAGE] 


A damaged object was encountered. 


A referenced object is damaged. The object cannot be used. 
[EFAULT] 


The address used for an argument is not correct. 
In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that is not valid. 
[ENOENT] 
No such path or directory. 


The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


No entry found for name specified. 
[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Usage Notes 


1. Although Qp0zGetEnv() is threadsafe, if a thread calls an environment variable function while another thread is accessing an 
environment variable from the environ array the thread may see undefined results. The environ array can be accessed directly or 
by using a pointer returned from the getenv() or Qp0zGetEnv() functions. The environment contents are only protected during 
calls to the environment variable functions. 


2. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer value associated with each 
environment variable. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


e@ putenv()--Change or Add Environment Variable 


e Qp0zDIitEnv()--Delete an Environment Variable 


e Qp0zDitSysEnv(Q--Delete a System-Level Environment Variable 
e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 


e@ Qp0zGetS ysEnv()--Get Value of System-Level Environment Variable 


e@ Qp0zInitEnv()--Initialize Environment for Variables 


e Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


e@ Qp0zPutSysEnv()--Change or Add a System-Level Environment 


Example 


See the example of using getenv() in putenv()--Change or Add Environment Variable. 
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Qp0zGetSysEnv()--Get Value of System-Level Environment 
Variable 


Syntax 


#include <qp0z1170.h> 


int Qp0OzGetSysEnv(const char *name, 
char *value, int *value_size, 
int *ccsid, void *reserved) ; 


Threadsafe: Yes 


The Qp0zGetSysEnv() function gets the value of a system-level environment variable name by searching the system-level environment 
variable list for a string of the form name=value. The value and the coded character set identifier (CCSID) associated with the 
environment variable name are returned. 


Authorities 


None 


Parameters 


name 

(Input) The name of an environment variable. 
value 

(Input/Output) The address of the buffer to receive the value. 
value_size 


(Input/Output) A pointer to an integer that contains the information about the size of the value buffer. Before calling 
Qp0zGetSysEnv(), this parameter should contain the size of the value buffer. If the size of this parameter is large enough to 
receive the value, then this field will contain the exact size of value upon returning from Qp0zGetSysEnv(). If the size of this 
parameter is not large enough to receive the value, then this field will contain the exact size required and ENOSPC will be the 
return value. In this case, the value buffer is not modified. 


cesid 
(Input/Output) The address of the variable to receive the CCSID associated with this variable. 
reserved 


(Input) Reserved for future use. Currently, the only allowed value is NULL. 


Return Value 


Qp0zGetSysEnv() successfully found the environment string. value and ccsid contain the value and CCSID for the variable 
name in the system-level environment variable list. 


errval 


Qp0zGetEnv( was not successful. errval indicates the error. 


Error Conditions 


If Qp0zGetSysEnv() is not successful, errval indicates one of the following errors. 
[EFAULT] 


The address used for an argument is not correct. 


In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that is not valid. 
[EINVAL] 


An invalid parameter was found. 
A parameter passed to this function is not valid. 


The value for the reserved parameter was not NULL. 
[ENOENT] 
No such path or directory. 


The directory or a component of the path name specified does not exist. 
A named file or directory does not exist or is an empty string. 


No entry found for name specified. 
[ENOSPC] 


No space available. 


The requested operations required additional space on the device and there is no space left. This could also be caused by 
exceeding the user profile storage limit when creating or transferring ownership of an object. 


Insufficient space remains to hold the intended file, directory, or link. 


The size of the value buffer was not big enough to receive the value. 
[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Usage Notes 


1. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer value associated with each 
environment variable. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


e@ putenv()--Change or Add Environment Variable 


e@ Qp0zDItEnv()--Delete an Environment Variable 


@ Qp0zDitSysEnv()--Delete a System-Level Environment Variable 
e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


e Qp0zInitEnv()--Initialize Environment for Variables 


e Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


@ Qp0zPutSysEnv(Q--Change or Add a System-Level Environment 


Example 


See the example of using Qp0zGetSysEnv() in Qp0zPutSysEnv()--Change or Add a System-Level Environment. 
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QpO0zinitEnv()--Initialize Environment for Variables 


Syntax 


#include <qp0z1170.h> 


int QpOzInitEnv (void) ;; 
Threadsafe: Yes 


The Qp0zInitEnvQ function sets the external variable environ to a pointer to the current environment list. (On the iSeries server, 
environ is initialized to NULL when an activation group is started.) 


Note: Although it is possible for a user's program to directly read the environ array, use of the getenv() or Qp0zGetEnv() functions is 
recommended. 


Parameters 


None. 


Return Value 


Qp0zInitEnv( successfully initialized the environment. 


Qp0zInitEnv() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If QpOzInitEnv() is not successful, errno indicates the following error. 
[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


@ putenv()--Change or Add Environment Variable 


e Qp0zDItEnv()--Delete an Environment Variable 


e Qp0zDitSysEnv()--Delete a System-Level Environment Variable 

e@ Qp0zGetAllSysEnvQ--Get All System-Level Environment Variables 
e Qp0zGetEnv()--Get Value of Environment Variable (Extended) 

@ Qp0zGetSysEnvQ--Get Value of System-Level Environment Variable 
e Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


e Qp0zPutSysEnv(--Change or Add a System-Level Environment 
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Qp0zPutEnv()--Change or Add Environment Variable 
(Extended) 


Syntax 


#include <qp0z1170.h> 


int QpOzPutEnv(const char *string, int ccsid);; 


Threadsafe: Yes. See Usage Notes for more information. 


The Qp0zPutEnv() function is an OS/400 extension to the standard putenv() function. Qp0zPutEnv() sets the value of an environment 
variable by altering an existing variable or creating a new variable. In addition, it specifies a CCSID (coded character set identifier) to 
be associated with the environment variable. 


The string parameter points to a string of the form name=value, where name is the environment variable and value is the new value for 
it. 


The name cannot contain a blank. For example, 


PATH NAME=/my_lib/joe_user 


is not valid because of the blank between PATH and NAME. The name can contain an equal (=) symbol, but the system interprets all 
characters following the first equal symbol as being the value of the environment variable. For example, 


PATH=NAME=/my_lib/joe_user 


will result in a value of 'NAME=/my_lib/joe_user' for the variable PATH. 


Parameters 


string 
(Input) A pointer to the name=value string. 
cesid 
(Input) A CCSID to be associated with this environment variable. If 0 is specified, the default CCSID for the job is used. 


Return Value 


Qp0zPutEnv() was successful. 


Qp0zPutEnv() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If Qp0zPutEnv() is not successful, errno indicates one of the following errors. 
[EDAMAGE] 


A damaged object was encountered. 


A referenced object is damaged. The object cannot be used. 
[EFAULT] 


The address used for an argument is not correct. 


In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that is not valid. 
[EINVAL] 


An invalid parameter was found. 
A parameter passed to this function is not valid. 


For example, the string may not be in the correct format. 
[ENOMEM] 


Storage allocation request failed. 
A function needed to allocate storage, but no storage is available. 


There is not enough memory to perform the requested function. (There is a limit of 4095 environment variables per job.) 
[EUNKNOWN] 
Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are 
indicated, then retry the operation. 


Usage Notes 


1. Although Qp0zPutEnv() is threadsafe, if a thread calls an environment variable function while another thread is accessing an 
environment variable from the environ array the thread may see undefined results. The environ array can be accessed directly or 
by using a pointer returned from the getenv() or Qp0zGetEnv() functions. The environment contents are only protected during 
calls to the environment variable functions. 


2. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer value associated with each 
environment variable. 


Related Information 


e@ The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e getenv()--Get Value of Environment Variable 


@ putenv()--Change or Add Environment Variable 


e Qp0zDItEnv()--Delete an Environment Variable 


e Qp0zDitSysEnv()--Delete a System-Level Environment Variable 
@ Qp0zGetAllSysEnv()--Get All System-Level Environment Variables 


@ Qp0zGetSysEnv()--Get Value of System-Level Environment Variable 


e@ Qp0zInitEnv()--Initialize Environment for Variables 


e Qp0zPutSysEnv()--Change or Add a System-Level Environment Variable 


Example 


See the example of using putenv() in putenv()--Change or Add Environment Variable. 
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Qp0zPutSysEnv()--Change or Add a 
System-Level Environment Variable 


Syntax 


#include <qp0z1170.h> 


int QpOzPutSysEnv(const char *string, int ccsid, 
void *reserved) ; 


Threadsafe: Yes 


Qp0zPutSysEnv() function sets the value of a system-level environment variable by altering an existing 
variable or creating a new variable. In addition, it specifies a CCSID (coded character set identifier) to be 
associated with the environment variable. 


The string parameter points to a string of the form name=value, where name is the environment variable 
and value is the new value for it. 


The name cannot contain a blank. For example, 


PATH NAME=/my_lib/joe_user 


is not valid because of the blank between PATH and NAME. The name can contain an equal (=) symbol, 
but the system interprets all characters following the first equal symbol as being the value of the 
environment variable. For example, 


PATH=NAME=/my_lib/joe_user 


will result in a value of 'NAME=/my_lib/joe_user' for the variable PATH. 


Parameters 


string 
(Input) A pointer to the name=value string. 
ccsid 


(Input) A CCSID to be associated with this environment variable. If 0 is specified, the default 
CCSID for the job is used. 


reserved 


(Input) Reserved for future use. Currently, the only allowed value is NULL. 


Authorities 


*JOBCTL special authority is required to add or change a system-level environment variable. 


Return Value 


0 
Qp0zPutSysEnv() was successful. 
errval 


Qp0zPutSysEnv() was not successful. errval is set to indicate the error. 


Error Conditions 


If Qp0zPutSysEnv() is not successful, errval indicates one of the following errors. 
[EFAULT] 


The address used for an argument is not correct. 

In attempting to use an argument in a call, the system detected an address that is not valid. 

While attempting to access a parameter passed to this function, the system detected an address that 
is not valid. 


[EINVAL] 


An invalid parameter was found. 

A parameter passed to this function is not valid. 

For example, the string parameter was not in the correct format or the value for the reserved 
parameter was not NULL. 


[ENOMEM] 


Storage allocation request failed. 
A function needed to allocate storage, but no storage is available. 
There is not enough memory to perform the requested function. (There is a limit of 4095 
system-level environment variables.) 
[EOPNOTSUPP] 
Operation not supported. 


The operation, though supported in general, is not supported for the requested object or the 
requested arguments. 


This error is returned if the environment variable that is being added is 
QIBM_CHILD_JOB_SNDINQMSG. See spawn() in or spawnp() in for details on 
QIBM_CHILD_JOB_SNDINQMSG. 


[EPERM] 


Operation not permitted. 


You must have appropriate privileges or be the owner of the object or other resource to do the 
requested operation. 


You must have *JOBCTL special authority to add or change system-level environment variables. 
[EUNKNOWN] 


Unknown system state. 


The operation failed because of an unknown system state. See any messages in the job log and 
correct any errors that are indicated, then retry the operation. 


Usage Notes 


1. No translation is done based on the CCSID. The CCSID is just stored and retrieved as an integer 
value associated with each environment variable. 


Related Information 


e The <qp0z1170.h> file (see Header Files for UNIX-Type Functions) 


e@ getenv()--Get Value of Environment Variable 


@ putenv()--Change or Add Environment Variable 


e@ Qp0zDItEnv(--Delete an Environment Variable 


e Qp0zDitSysEnv()--Delete a System-Level Environment Variable 


e@ QOp0zGetAllSysEnv(Q)--Get All System-Level Environment Variables 
e@ Qp0zGetEnv()--Get Value of Environment Variable (Extended) 


@ Qp0zGetSysEnv()--Get Value of System-Level Environment Variable 


e@ Qp0zInitEnv(--Initialize Environment for Variables 


e Qp0zPutEnv()--Change or Add Environment Variable (Extended) 


Example 
The following example uses Qp0zPutSysEnv(Q), Qp0zGetSysEnv(), and Qp0zDItSysEnv(). 


#include <stdio.h> 
#include <errno.h> 
#include <stdlib.h> 
#include <qp0z1170.h> 


int main(int argc, char **argv) 


{ 


char *varl = "PATH=/:/home"; 
char *namel = "PATH"; 
char *vall = NULL; 


int re, ccsid, size; 


/* Add the system-level variable PATH */ 

/* using default ccsid A 

ccsid = 0; 

re = QpOzPutSysEnv(varl, ccsid, NULL); 

if(rce != 0) 

{ 
printf("Error from QpO0zPutSysEnv while adding <%s>\n",varl)j; 
printf("errno = $d\n",rc); 
return rc; 


} 
printf("<%Ss> added to system-level env var list\n",varl); 


/* Get the value of the variable PATH */ 
size = 100; 
vall = (char *)malloc(size); 


re = QpOzGetSysEnv(namel, vall, &size, &ccsid, NULL); 
if (rc == ENOSPC) 

{ 

/* The buffer size was not enough to get the value */ 
/* Increase the buffer to size */ 
vall = (char *)realloc(vall, size); 

re = QpO0zGetSysEnv(namel, vall, &size, &ccsid, NULL); 
} 


if(rce != 0) 

{ 

printf ("Error from Qp0zGetSysEnv while retrieving"); 
printf ("<%s>, errno = %$d\n", namel, rc); 

return rc; 


} 
printf("<%Ss> retrieved, value is <%s>\n",namel,vall); 


/* Delete the PATH variable */ 

re = QpOzD1ltSysEnv(namel, NULL); 

if(re != 0) 

{ 

printf("Error from Qp0OzD1tSysEnv while deleting"); 
printf ("<%s>, errno = %$d\n", namel, rc); 

return, 7c; 


} 
printf("<%Ss> deleted from system-level env var list\n",namel) ; 


return 0; 


} 
Output: 
<PATH=/:/home> added to system-level variable list 


<PATH> retrieved, value is </:/home> 
<PATH> deleted from system-level variable list 


For other examples, see the two-part example in API Examples for saving and restoring system-level 
environment variables. 
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Header Files for UNIX-Type Functions 


Programs using the UNIX-type functions must include one or more header files that contain information 
needed by the functions, such as: 


e Macro definitions 
e Data type definitions 
e Structure definitions 
e Function prototypes 
The header files are provided in the QS YSINC library, which is optionally installable. Make sure 


QSYSINC is on your system before compiling programs that use these header files. For information on 
installing the QSYSINC library, see Data structures and the QSYSINC Library. 


The table below shows the file and member name in the QS YSINC library for each header file used by the 
UNIX-type APIs in this publication. 


Name of File in 
Name of Header File QSYSINC Name of Member 


[| arpa/ineth [| arpa/ineth [ ARPA [INET 


a 
a * 

tik | | so 
[  —sbseerrch CEC A~<“‘i‘~*Y:S*é‘éiBSEERRR 
[ss direnth [CM Rs—~<“i«i‘Cé«zYS)~OCéIRENT 
[ emoh [| H [ERRNO] | 
[_eph | SOS 

| evinttypes. h | | TNS 
ee ee ee 
[| %netinet/iemp6.h NETINE |  ICMP6& 
[| netinetinh NETINET [| WN 
| netinet/ip_icmp.h NETINET [|  IPICMP 


mo) oo) eo) eo) a) ee} ee} ey] 


| netinet/ip.h NETINET | IP 
| 2’netinet/ip6.h NETINET | IP6& 
| netinet/tcp.h NETINET TCP 


| netinet/udp.h NETINET UDP 

[netns/idph = | 0S NETNS) [CIDP 
[netns/ipxh = |S NETNS) [CPX 
[so netns/ns-h | NETNS) [CONST 
[so netns/sp-b |S NETNS) [SP 
[netrouteh = [)CNET)=—~<C;«é‘L”)~Ss*'<‘éROUTEECi:*s 
[—snettel/telLh «= sis[))sSNETTEL =o [)ti‘<‘STENRES—“( isis 


an 


[  oosh fC OS2 

[|  —sosddefh fC ASE S2DEF 
[ pwd fC PWD 

[0 gh fH QLG 

| —s qpOlfloph fs QPOLFLOP 
| Bqp0limih | | QPOLIRNLE 

| 2>qpOlror.h | | QPOLROR& 

|  qpOzolsm-h fC HH—C*ST ss QPOZOLSM 
| — qpOztrech fC QPOZTRE 
|  qpOztrmlh [| CSTs QPOZTRML 
| #qsoasync.h | | QSOASYNC% 
| qtnxaapi.h | QTNXAAPI 
[ qtnxadtph fC H——CSE ss QQTNXADTP 
|  qtomeapih sf] CM ™—C~@TSsC QQOMEEAP 


TRIG 


| qtossapi.h | H | QTOSSAPI 
| resolv.h | H | RESOLVE 


an 


| semaphore.h | | SEMAPHORE 


[signal | CMHC SIGNAL 
[|  spawnh Cf CM ™~“<~S SPAWN 
[ssh fA SSL 

| sysferrnoh = fC H™:~iT SC ERRNOU 
[| sysfioctLh SYS [|  IOCTL 
| ——ssys/ipeh SYS [ woe 


| sys/layout.h | H | LAYOUT 
| sys/limits.h | H | LIMITS 


| —ssys/msg-ho SYS MSG 

[| sys/param.h SYS [ PARAM 
| #*sys/resource.h SYS | RESOURCE® 

| —ssys/sem-h SYS SEM 

| sys/setimp.h SYS | ‘SETIMP 
| sys/shm.h SYS SHM 

[| sys/signalh SYS [ SIGNAL 
[| _sys/socketh SYS [SOCKET 
[| —sys/stath SYS [ STAT” 


| sys/statvfs.h SYS | STATVFS 


| —ssysfimeh SYS [| TIME 
[| sys/types.b SYS [TYPES si 
| —ssys/uio.h SYS UIO 

[ sys SYS [ UN 
| —ssys/waith SYS | WAIT 
| Sulimit.h H | ULIMIT*& 

[| sounistdh fC HSE UNISTD 
[  soutimeh fC UTIME 


You can display a header file in QS YSINC by using one of the following methods: 


e Using your editor. For example, to display the unistd.h header file using the Source Entry Utility 
editor, enter the following command: 


STRSEU SRCFILE(QSYSINC/H) SRCMBR(UNISTD) OPTION(5) 


e Using the Display Physical File Member command. For example, to display the sys/stat.h header 
file, enter the following command: 


DSPPFM FILE(QSYSINC/SYS) MBR(STAT) 


You can print a header file in QSYSINC by using one of the following methods: 


e Using your editor. For example, to print the unistd.h header file using the Source Entry Utility 
editor, enter the following command: 


STRSEU SRCFILE(QSYSINC/H) SRCMBR(UNISTD) OPTION (6) 
e Using the Copy File command. For example, to print the sys/stat.h header file, enter the following 


command: 


CPYF FROMFILE(QSYSINC/SYS) TOFILE(*PRINT) FROMMBR (STAT) 


Symbolic links to these header files are also provided in directory /QIBM/include. 
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Errno Values for UNIX-Type Functions 


Programs using the UNIX-type functions may receive error information as errno values. The possible 
values returned are listed here in ascending errno value sequence. 


[Name [Value [Test 

~——— a ee domain error occurred in a math 
function. 

[ERANGE = GE [300200 A [Arangeerror occurred. = error [Arangeerror occurred. = 

—| C _— Data was truncated on an input, output, or 
update operation. 

EN [ENOTOPEN [3004 [Fileisnotopen. is not [Fileisnotopen. 


—— OTREAD — [File i is not opened for read operations. 
EIO [3006 [Input/output error. 


EN [ENODEV [3007 N [Nosuchdevice. [Nosuchdevice. device. 

ae —_ Cannot get single character for files 
opened for record I/O. 

EN [ENOTWRITE [30090 [File is not opened for write operations. is not [File is not opened for write operations. for write operations. 


a —— [The stdin stream cannot be opened. 
[ESTDOUT [3011 [The stdout stream cannot be opened. 


[ESTDERR [30120 [The stderr stream cannot be opened. stderr stream cannot be [The stderr stream cannot be opened. 

_—| a The positioning parameter in fseek is not 
correct. 

[EBADNAME AME [30140 [The object name specified is not correct. — [The object name specified is not correct. — name specified is not correct. 


a ——! The type variable specified on the open 
function is not correct. 


[EBADPOS 3017s [The position specifier is not correct. position [The position specifier is not correct. is not correct. 


17 
EN a — There is no record at the specified 
position. 
ENUMMBRS 3019 Attempted to use ftell on multiple 
members. 
ENUMRECS 3020 The current record position is too long for 
ftell. 
EINVAL 3021 The value specified for the argument is not 
correct. 
EBADFUNC 3022 Function parameter in the signal function 
is not set. 
[302500 


EN [ENOENT T No [No such path or directory, = [No such path or directory, = or directory. 


FoR? ——— ht’ —— ae 
[EPERM  =——<CS~s«LB27_~——SSC«*d Phe Oplerationn is not permitted. = 
[EBADDATA  ——s[3028——Ss[Meessage dataisnotvalid. = 
[EBUSY ==—=«S(38029—s Resource busy, 
[EBADOPT —s*(3040 = Option specified is not valid. 
[ENOTUPD ~—s*([3041 =~‘ File is not opened for update operations. 
[ENOTDLT ~—*[3042. [File is not opened for delete operations. 


EPAD 3043 The number of characters written is 
shorter than the expected record length. 

EBADKEYLN 3044 A length that was not valid was specified 
for the key. 

EPUTANDGET 3080 A read operation should not immediately 
follow a write operation. 

EGETANDPUT 3081 A write operation should not immediately 
follow a read operation. 

[EIOERROR [3101 [A nonrecoverable I/O error occurred. 

[EIORECERR [3 102 [A recoverable I/O error occurred. 

[EACCES [3401 [Permission denied. 


[EN OTDIR [3403 [N ot a directory. 
[ENOSPC [3404 [No space is available. 


[EXDEV [3405 Improper link, [Improperlink, 


[34050 
aa_— 3406 Operation would have caused the process 
to be suspended. 
EWOULDBLOCK 3406 Operation would have caused the process 
to be suspended. 
[3407 


[EINTR [3407 SS s‘[Interrupted function call. [Interrupted function call. call. 


ee— 3408 The address used for an argument was not 
correct. 


[ETIME [3409 [3409 [Operation timedout. [Operation timedout. out. 
—_——— [3415 0 No [No such device oraddress. device [No such device oraddress. address. 
SEs i Pa 
failure 
[ERECURSE [3419 [Recursive attempt rejected. = attempt [Recursive attempt rejected. = 
 ORNESE Si —— see 
[EADDRNOTAVAIL [342200 [Address is notavailable. = [Address is notavailable. = not available. 
ESINOSUORT > pean type of socket is not supported in this 
protocol family. 
[EALREADY [342300 [3423 [Operation is already in progress. = is already in progress. 
REE ABORTED [34240000 [Connection ended abnormally. ended [Connection ended abnormally. 
25 


ECONNRTUSED — aS rma ba tn te 
connect operation 
i ae ce 
reset by that socket 
[EDESTADDRREQ. [3427 00 [3427 | Operation requires destination address. requires [Operation requires destination address. address. 
[EHOSTDOWN [3428s {Ar remote host is notavailable. 
[EHOSTUNREACH [3429 ‘A route to the remote host is not available. 
[EINPROGRESS —[3430. Ss |Operationin progress. = 
[EISCONN «(3431s {A connection has already been established. 
[EMSGSIZE «(3432s [Message size isoutofrange. 
[ENETDOWN  ——s[3433.—s*[ The network currently is not available. 


ENETRESET 3434 A socket is connected to a host that is no 
longer available. 


[ENETUN REACH [3435 [Cannot reach the destination network. 

ENOBUFS 3436 There is not enough buffer space for the 
requested operation. 

ENOPROTOOPT 3437 The protocol does not support the 

specified option. 

ENOTCONN 3438 Requested operation requires a 
connection. 

ENOTSOCK 3439 The specified descriptor does not 
reference a socket. 

[EN OTSUP [3440 [Operation is not supported. 

[EOPN OTSUPP [3440 [Operation is not supported. 


EPFNOSUPPORT 3441 The socket protocol family is not 
supported. 

EPROTONOSUPPORT |3442 No protocol of the specified type and 
domain exists. 

EPROTOTYPE 3443 The socket type or protocols are not 
compatible. 

ERCVDERR 3444 An error indication was sent by the peer 
program. 


[ESHUTDOWN [3445 [Cannot send data after a shutdown. 
[ESOCKTN OSUPPORT [3446 [The specified socket type is not supported. 


ETIMEDOUT 3447 A remote host did not respond within the 
timeout period. 

EUNATCH 3448 The protocol required to support the 
specified address family is not available at 
this time. 


[EBADF = =—S—=«&;3'45——SsDescriptorisnot valid, 
[EMFILE  =—S*[3452,—S——Ss {Too many open files for this process. 
[ENFILE =——=S&3453. Ss [Too many open files inthe system. 
EPIPE == ~—«*(3455, ss (Brokenpipe. 
[ECANCEL =——s«[3456.———s|Operationcancelled. = 
[EEXIST =———s«*(3'KST_—— sie exists, 
[EDEADLK =——s*[3459_ Resource deadlock avoided. 
[ENOMEM ——s«[3460—Ss« Storage allocation request failed. = 
62 


a 34 The synchronization object no longer 
exists because the owner is no longer 
running. 

EDESTROYED 3463 The synchronization object was destroyed, 
or the object no longer exists. 

[ETERM [3464 00—CO [3464 Operation was terminated. = was [Operation was terminated. = 


aes —— OENT1 [3 465 [N o such file or directory. 


ENOEQFLOG 3466 Object is already linked to a dead 
ones sag 


[EEMPTYDIR [3 467 [Directoryisempty. = is empty. 


EMLINK 3468 Maximum link count for a file was 
exceeded. 


ESPIPE  =—~SC~«&346—— “Seek request is not supported for object. 
[ENOSYS —————=«*3470.—S—SSs|Function not implemented. = 
[EISDIR ——i(ass—t*é«*BATALC Specified targetisadirectory, = 
[EROFS =———~—é«i;3B220-—— Read-only file system. 
[EUNKNOWN  —s[3474.— ss [Unknown system state. = 
[EITERBAD  =——s«(34750—— iterator isnotvalid. = 
[EITERSTE  =—sS*(3476 ~—S—SCs=|Iterator is in wrong state for operation. 
[EHRICLSBAD —s [3477 Ss HIRI classisnotvalid. 
[EHRICLBAD ~—s([3478 = {IRI subclassisnot valid. = 
[EHRITYPBAD —[3479 Ss {HRI typeisnotvalid, = 
[ENOTAPPL —=—s*[3480.—~——Ss [Datta requested is not applicable. = 
[EHRIREQTYP  =—[3481_ = {ARI request type isnot valid. 
[EHRINAMEBAD —_ [3482s {HRT resource name isnot valid. 
[EDAMAGE —s([3484.————s [A damaged object was encountered. 
[ELOOP  ———~™—=é«S;3485— SA cop exists in the symbolic links. 
[ENAMETOOLONG [3486 = {Apathnameistoolong, 
[ENOLCK = =——s«*(3487,——s No locksare available. = 
[ENOTEMPTY —*[3488 ~=——Ss[Directory isnotempty. = 
[ENOSYSRSC [3489s System resources are not available. = 
[ECONVERT =— [3490s |Conversionerror, 


[E2BIG [3491 [3491 Ss [Argumentlististoolong, [Argument lististoolong, = is too long. 
—=———— 3492 Conversion stopped due to input character 
that does not belong to the input codeset. 


[ETYPE  ——™ [3493 [3493 |Objecttypemismatche type [Object type mismatch, 
—— 3494 Attempted to reference a directory that 
was not found or was destroyed. 
EBADOBJ 3495 Attempted to reference an object that was 
not found, was destroyed, or was 
damaged. 
EIDXINVAL 3496 Data space index used as a directory is not 
valid. 
[ESOFTDAMAGE [3497 [3497 [Objecthas softdamage. [Objecthas softdamage. soft damage. 


Soe | OTENROLL 3498 User is not enrolled in system distribution 
ies sae———— 


[EOFFLINE = 3499 [3499 |Objectissuspended. is suspended. 


[34990 
oe —— [3 500 [Object i is a read-only object. 


EEAHDDSI 3501 Hard damage on extended attribute data 
space index. 

EEASDDSI 3502 Soft damage on extended attribute data 
space index. 

EEAHDDS 3503 Hard damage on extended attribute data 
space. 

EEASDDS 3504 Soft damage on extended attribute data 

| | ee 


[EEADUPRC [3505 [Duplicate extended attribute record. 


ELOCKED 3506 Area being read from or written to is 
locked. 


[EFBIG [3507 [3507 ss |Objecttoolarge. [Objecttoolarge, large. 
509 


a—_—— 3 The semaphore, shared memory, or 
message queue identifier is removed from 
the system. 

OMSG e The queue does not contain a message of 


the desired type and (msgflg logically 
ANDed with IPC_NOWAIT). 


[EFILECVT = [351k [File ID conversion of a directory failed. ID conversion of a [File ID conversion of a directory failed. failed. 

a——— _— A file ID could not be assigned when 
linking an object to a directory. 

[ESTALE [3513 [File handle was rejected by server. handle was [File handle was rejected by server. by server. 


es} — oes 
[ENOTSIGINIT ——[3516 [Process is not enabled for signals. 

[ECHILD  =———~—=«~S(;B'SS'T.— Ss Nochild process. 
[EBADH = =—sS«(3520.——sHandleisnotvalid, = 


iN YREFS 3523 The operation would have exceeded the 


maximum number of references allowed 
for a descriptor. 


[ENOTSAFE =——s [3524s |Functionisnotallowed. = 
ESC aW—— sk —— pice ee ——— 
[EIRNDAMAGE ~—[3526 Ss |Jourmalisdamaged. 
[EJRNINACTIVE ~— [3527s |Jourmalisimactive, = 
[EIRNRCVSPC [3528 = s‘|Journal space or system storage error. 
[EIRNRMT = ——s*(3529, Ss Journalisremote. 
[ENEWJRNRCV [3530s [New journal receiver isneeded. 
[ENEWJRN  ———s«(3531.=——Ss New journalisneeded. = 
[EJOURNALED [3532s Objectalready journaled. = 
[EIRNENTTOOLONG 3533 [Entry istoolargetosend. 
[EDATALINK —s [3534s [Object is adatalink object. 
[ENOTAVAIL ~—s 3535. IASPisnotavailable. = 


[ENOTTY = OTTY [35360 [I/O control operation is not appropriate. control [I/O control operation is not appropriate. is not appropriate. 

sues 3540 Attempt to write or truncate file past its 
=o ie file size limit. 

[ETXTBSY [35430 [Textfilebusy. file [Textfilebusy. 

SENG OTSET ~— [ASP group not set forthread. [ASP group not set forthread. not set for thread. 


—— a A system call was interrupted and may be 
restarted. 


Top | UNIX-Type APIs | APIs by category 


